Node / meshtastic / Meshtastic-Android / files / core / repository / src / commonMain / kotlin / org / meshtastic / core / repository / HistoryManager.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.core.repository

Tff7b72import T7ee787org.meshtastic.proto.ModuleConfig

T8b949e/** Interface for managing store-and-forward history replay requests. */

Tff7b72interface T56d364HistoryManager Tb4b4b4{

T8b949e/**

* Requests a history replay from the radio.

*

* @param trigger A string identifying the trigger for the request (for logging).

* @param myNodeNum The local node number.

* @param storeForwardConfig The store-and-forward module configuration.

* @param transport The transport method being used (for logging).

* @param expectedConnectionVersion The connected lifecycle generation that owns this request.

* @throws LocalNodeUnavailableException when no device is selected or the local node number is unknown.

* @throws PacketQueueRejectedException when the expected lifecycle generation is stale or queue admission fails.

*/

Tff7b72suspend Tff7b72fun Td2a8ffrequestHistoryReplayTb4b4b4(

Te6edf3triggerTb4b4b4: Tffa657StringTb4b4b4,

Te6edf3myNodeNumTb4b4b4: Tffa657Int?Tb4b4b4,

Te6edf3storeForwardConfigTb4b4b4: Te6edf3ModuleConfigTb4b4b4.Te6edf3StoreForwardConfigTff7b72?Tb4b4b4,

Te6edf3transportTb4b4b4: Tffa657StringTb4b4b4,

Te6edf3expectedConnectionVersionTb4b4b4: Tffa657LongTb4b4b4,

Tb4b4b4)

T8b949e/**

* Updates the last requested history marker.

*

* @param source A string identifying the source of the update (for logging).

* @param lastRequest The timestamp or sequence number of the last received history message.

* @param transport The transport method being used (for logging).

*/

Tff7b72fun Td2a8ffupdateStoreForwardLastRequestTb4b4b4(Te6edf3sourceTb4b4b4: Tffa657StringTb4b4b4, Te6edf3lastRequestTb4b4b4: Tffa657IntTb4b4b4, Te6edf3transportTb4b4b4: Tffa657StringTb4b4b4)

Tb4b4b4}